home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / param10 / jmparam.txt < prev    next >
Text File  |  1995-08-23  |  4KB  |  111 lines
  1. A major ommission in Visual Basic is the inability to pass parameters
  2. to forms.  Generally this is handled by using global variables or
  3. assigning values to controls on a form.  Neither is very satisfactory
  4. since you have the problem of synchonization:  How do you load two
  5. forms of the same type at the same time?  
  6.  
  7. In addition you do not get event notification using global 
  8. variables.  In VB programming you want the form to be able to get 
  9. data AND to know when data is available.
  10.  
  11. The VisualWare Parameter control allows you exchange data with
  12. a form and to notify a form of events.  In effect it gives you the 
  13. ability to call a function in a form. 
  14.  
  15. To use the Parameter Control: 
  16.  
  17. 1. Include JMPARAM.VBX in your project.
  18. 2. Include JMPARAM.BAS in your project.
  19. 3. Place a Parameter Control on the forms you want to call.
  20. 4. Add code to process CallForm events for your parameters controls.
  21.  
  22. To 'call' a form use the CallForm function that is described below.
  23.  
  24.  
  25. Standard Properties
  26. -------------------
  27. Name
  28. Left
  29. Type
  30. Parent
  31. Hwnd
  32.  
  33. Custom Properties
  34. -------------------
  35. The ArgCount and Argument properties are only valid while processing
  36. a CallForm event.  If accessed at any other time an error occurs.
  37.  
  38. ArgCount:  The number of parameters passed to CallForm event.  This
  39. is the size of the Argument property array.  This properties is read
  40. only.
  41.  
  42. Argument:  The arguments passed to the CallForm event.  This is a 
  43. property array  Argument (1) is the first element and the ArgCount
  44. property gives the index for the last element.  This property
  45. is read/write so you can return values to the calling procedure.
  46.  
  47. Event
  48. -----
  49.  
  50. CallForm (CallType as integer, ReturnValue as Long)
  51.  
  52.  
  53. This event is generated when you call the CallForm function.  CallType
  54. is passed directly from the CallForm function.  It is not interpreted in
  55. any way.  ReturnValue is the value returned by the CallForm function 
  56. calling the form.
  57.  
  58. Within the CallForm event (or any functions or subroutines called
  59. from the CallForm event) you can access the Argument and ArgCount
  60. properties of the parameter control.  You can update the values
  61. of the Argument() properties to return values to the caller.
  62.  
  63.  
  64. Calling a Form
  65. --------------
  66.  
  67. Use the CallForm function to call a form.  The exact definition of the
  68. function is in JMPARAM.BAS.  This is a summary.
  69.  
  70. function CallForm (Frm as Form, CallType as Integer, Args () as string) as long
  71.  
  72. Parameters:
  73.  
  74. Frm:    The form you want to call.  If the form you specify does not
  75. have a parameter control no error occurs and the return value is unpredictable.
  76.  
  77. CallType:  This value is passed to the form.  It is not interpreted in any
  78. way.  You can use this value to specify different actions for the form
  79. to take.
  80.  
  81. Args(): A string array of arguments to pass to the form.  The form can
  82. update this array.  You can specify any array bounds however the
  83. form always sees the first element in the array as one.
  84.  
  85. Return Value:  The return value is set in the CallForm event.
  86.  
  87. Restrictions
  88. ------------
  89. 1. You can only place one Parameter Control on a form.
  90.  
  91. 2. The Parameter control supports up to four nested calls.  However
  92. any calls after the fourth are ignored and CallForm returns -1.
  93.  
  94. 3. Do not unload the form containing a Parameter Control during the
  95. call FormEvent.
  96.  
  97. The sample application shows how the Parameter Control can be used to
  98. exchange data among forms.  
  99.  
  100. Send Problem Reports to
  101.  
  102. visualware@interramp.com
  103.  
  104.  
  105. VisualWare, Inc.
  106. 1675 East Main St, Suite 218
  107. Kent OH 44249
  108.  
  109. (216) 258-9012
  110.  
  111.